Road Map to QuickTime 3

The Standard Image-Compression Dialog Component

This chapter describes the standard image-compression dialog component. The image-compression dialog provides a user interface for setting the compression parameters of still images and sequences. If your application creates movies, you should read about the image-compression dialog component. This chapter also contains a section describing how to create your own dialog component, although most developers will not need to do this.

About Standard Image-Compression Dialog Components

Inside Macintosh introduces the standard image-compression dialog component and illustrates the two standard dialog boxes.

Using Standard Image-Compression Dialog Components

Inside Macintosh describes how and when to use the dialog component and provides details, including sample code, for the following procedures

• Opening a Connection to a Standard Image-Compression Dialog Component
• Displaying the Dialog Box to the User
• Extending the Basic Dialog Box

Creating a Standard Image-Compression Dialog Component

Inside Macintosh describes the component type for a compression dialog component and defines the constants used for request codes. Developers planning to create a dialog component should read this section.

Standard Image-Compression Dialog Component Functions

Inside Macintosh defines the functions that you can use to work with standard image-compression dialog components. The functions are divided into groups that serve a common purpose.

• Getting Default Settings for an Image or a Sequence
• SCDefaultPixMapSettings
• SCDefaultPictHandleSettings
• SCDefaultPictFileSettings
• Displaying the Standard Image-Compression Dialog Box
• SCRequestImageSettings
• SCRequestSequenceSettings
• Compressing Still Images
• SCCompressImage
• SCCompressPicture
• SCCompressPictureFile
• Compressing Image Sequences
• SCCompressSequenceBegin
• SCCompressSequenceFrame
• SCCompressSequenceEnd
• Working With Image or Sequence Settings
• SCGetInfo
• SCSetInfo
• Specifying a Test Image
• SCSetTestImagePictHandle
• SCSetTestImagePictFile
• SCSetTestImagePixMap
• Positioning Dialog Boxes and Rectangles
• SCPositionRect
• SCPositionDialog
• SCGetBestDeviceRect
• Utility Function
• SCNewGWorld
• Application-Defined Function
• MyHook

Request Types

Inside Macintosh describes the request types used by the dialog component functions SCGetInfo and SCSetInfo . Use these request types to get and set compression parameters for images and sequences. There are several request types, each using different parameter data.

• The Spatial Settings Request Type
• The Temporal Settings Request Type
• The Data-Rate Settings Request Type
• The Color Table Settings Request Type
• The Progress Function Request Type
• The Extended Functions Request Type
• The Preference Flags Request Type
• The Settings State Request Type
• The Sequence ID Request Type
• The Window Position Request Type
• The Control Flags Request Type

Result Code

• Inside Macintosh defines a result code that an image-compression dialog function can return in the event of an error.

Data Types

Inside Macintosh defines the data types used with image-compression dialog component functions.

• SCModelFilterProcPtr
• SCModalHookProcPtr
• SCSpatialSettings
• SCTemporalSettings
• SCDataRateSettings
• SCExtendedProcs
• SCParams

Constants

Inside Macintosh defines the constants used with image-compression dialog component functions.